package com.hzsparrow.ai.service;

import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.Map;

/**
 * 文件服务接口
 */
public interface FileService {

    /**
     * 上传文件
     *
     * @param file 文件对象
     * @return 包含文件信息的Map，包括文件名、文件路径、解析内容等
     * @throws IOException 如果上传或解析过程出错
     */
    Map<String, Object> uploadFile(MultipartFile file) throws IOException;
    
    /**
     * 获取文件的访问URL
     *
     * @param filePath 文件相对路径
     * @return 完整的访问URL
     */
    String getFileUrl(String filePath);
} 